home *** CD-ROM | disk | FTP | other *** search
/ GFX Sensations 1 / Graphic Sensations - Volume 1.iso / tools / amiga / show / egsdvi.lha / EGSDVI.manual < prev    next >
Encoding:
Text File  |  1994-01-27  |  12.3 KB  |  254 lines
  1.  
  2.    NAME
  3.      EGSDVI - DVI Previewer for the EGS window system
  4.  
  5.    SYNOPSIS
  6.      egsdvi shrink/k/n, density/k/n, dpi/k/n, side/k, top/k, paper/k,
  7.             altfont/k, listfonts/s, hush/s, hushspecials/s, hushlostchars/s,
  8.             copy/s, thorough/s, version/s, mgs/k/n, page/k, width/k/n,
  9.             height/k/n, dvifile/f/a
  10.  
  11.    STATUS AND COPYRIGHT
  12.      This program is public domain. It may be distributed as long as the
  13.      program and this manual file are always distributed together with the
  14.      following copyright notice and are not modified in any way:
  15.              EGSDVI Copyright in 1993 by Dietmar Heidrich
  16.  
  17.    DESCRIPTION
  18.      EGSDVI is a program which runs under the EGS window system. It is used to
  19.      preview DVI files, such as are produced by TeX. EGSDVI needs EGS version 6
  20.      or higher.
  21.  
  22.      This program has the capability of showing the file shrunken by various
  23.      (integer) factors, and also has a `magnifying glass' which allows one to
  24.      see a small part of the unshrunk image momentarily.
  25.  
  26.      Before displaying any page or part thereof, it checks to see if the dvi
  27.      file has changed since the last time it was displayed.  If this is the
  28.      case, then EGSDVI will reinitialize itself for the new dvi file.  For this
  29.      reason, exposing parts of the EGSDVI window while TeX is running should be
  30.      avoided.  This feature allows you to preview many versions of the same
  31.      file while running EGSDVI only once.
  32.  
  33.      In addition to using keystrokes to move within the file, EGSDVI provides
  34.      buttons on the right side of the window, which are synonymous with vari-
  35.      ous sequences of keystrokes.
  36.  
  37.    SHELL OPTIONS
  38.      In addition to specifying the .dvi file (with or without the .dvi suffix),
  39.      EGSDVI supports the following command line options. The corresponding name
  40.      for the environment file (see below) is given in parantheses.
  41.  
  42.      page
  43.           Specifies the first page to show; the first page is the default.
  44.  
  45.      shrink
  46.           (shrinkFactor) Defines the initial shrink factor.  The default value
  47.           is 3.
  48.  
  49.      density
  50.           (densityPercent) Determines the density used when shrinking bitmaps
  51.           for fonts.  A higher value produces a lighter font.  The default
  52.           value is 40.
  53.  
  54.      dpi
  55.           (pixelsPerInch) Defines the size of the fonts to use, in pixels
  56.           per inch.  The default value is 300.
  57.  
  58.      altfont
  59.           (altFont) Declares a default font to use when the font in the dvi
  60.           file cannot be found.  This is useful, for example, with PostScript
  61.           <tm> fonts.
  62.  
  63.      listfonts
  64.           (listFonts) Causes the names of the fonts used to be listed.
  65.  
  66.      hushspecials
  67.           (hushSpecials) Causes EGSDVI to suppress warnings about \special
  68.           strings which it cannot process.
  69.  
  70.      hushlostchars
  71.           (hushLostChars) Causes EGSDVI to suppress warnings about references
  72.           to characters which are not defined in the font.
  73.  
  74.      hush
  75.           (hush) Causes EGSDVI to suppress all suppressable warnings.
  76.  
  77.      thorough
  78.           (thorough) EGSDVI will usually try to ensure that overstrike charac-
  79.           ters (e.g.  \notin) are printed correctly.  On monochrome displays,
  80.           this is always possible with one logical operation, either and or
  81.           or.  On color displays, however, this may take two operations, one
  82.           to set the appropriate bits and one to clear other bits.  If this
  83.           is the case, then by default EGSDVI will instead use the copy opera-
  84.           tion, which does not handle overstriking correctly.  The
  85.           `thorough' option chooses the slower but more correct choice.
  86.           See also copy, below.
  87.  
  88.      copy
  89.           (copy) Always use the copy operation when writing characters to
  90.           the display.  This option may be necessary for correct operation on
  91.           a color display, but overstrike characters will be incorrect.
  92.  
  93.      version
  94.           (version) Print information on the version of EGSDVI.
  95.  
  96.      sidemargin
  97.           (sideMargin) Specifies the side margin.
  98.           This should be a decimal number optionally followed by "cm",
  99.           e.g., 1.5 or 3cm, giving a measurement in inches or centimeters.
  100.           It determines the `home' position of the page within the window
  101.           as follows.  If the entire page fits in the window, then the margin
  102.           settings are ignored.  If, even after removing the margins from the
  103.           left, right, top, and bottom, the page still cannot fit in the win-
  104.           dow, then the page is put in the window such that the top and left
  105.           margins are hidden, and presumably the upper left-hand corner of
  106.           the text on the page will be in the upper left-hand corner of the
  107.           window.  Otherwise, the text is centered in the window.  See also
  108.           `M' under the KEYSTROKES section.
  109.  
  110.      topmargin
  111.           (topMargin) Specifies the top and bottom margins (see above).
  112.  
  113.      paper
  114.           (paper) Specifies the size of the printed page.  This may be of
  115.           the form wxh (or wxhcm), where w is the width in inches (or cm) and
  116.           h is the height in inches (or cm), respectively.  There are also
  117.           synonyms which may be used:  us (8.5x11), usr (11x8.5), legal
  118.           (8.5x14), foolscap (13.5x17), as well as the ISO sizes a1-a7, b1-
  119.           b7, c1-c7, a1r-a7r (a1-a7 rotated), etc.  The default size is 8.5 x
  120.           11 inches.
  121.  
  122.      mgs
  123.           (magnifierSize[n]) Specifies the size of the window to be used for
  124.           the `magnifying glass' for button n.  See the MOUSE ACTIONS sec-
  125.           tion.  Defaults are 200, 350, 600, 900, and 1200.  The shell option
  126.           lets you only specify the size for button 1.
  127.  
  128.      width
  129.           (width) Specifies the initial window width.
  130.  
  131.      height
  132.           (height) Specifies the initial window height.
  133.  
  134.      Note that EGSDVI must have a dvi file to display.
  135.  
  136.    WORKBENCH
  137.      For the workbench, you will need to click the icon of the dvi file to
  138.      display and then double-click the EGSDVI icon while pressing a shift key.
  139.      Note that EGSDVI must have a dvi file to display.
  140.  
  141.    KEYSTROKES
  142.      EGSDVI recognizes the following keystrokes when typed in its window.
  143.  
  144.      q    Quits the program.  'x' will do this, too.
  145.  
  146.      n    Moves to the next page.  Synonyms are Space, Control-M (Carriage
  147.           Return) and Control-J (Line Feed).  If you press shift
  148.           simultaneously, the top part of that page will be displayed.
  149.  
  150.      p    Moves to the previous page.  Synonym is `b'.  If you press shift
  151.           simultaneously, the bottom part of that page will be displayed.
  152.  
  153.      cursor-up
  154.      cursor-down
  155.      cursor-left
  156.      cursor-right
  157.           Moves into the specified direction.  Pressing an alternate key
  158.           simultaneously moves a bigger portion, pressing a shift key
  159.           moves to the appropriate border.
  160.  
  161.      R    Forces the dvi file to be reread.  This allows you to preview many
  162.           versions of the same file while running EGSDVI only once.
  163.  
  164.    MOUSE ACTIONS
  165.      If the shrink factor is set to any number other than one, then clicking
  166.      any mouse button will pop up a `magnifying glass' which shows the
  167.      unshrunk image in the vicinity of the mouse click.  This subwindow
  168.      disappears when the mouse button is released.  Different mouse buttons
  169.      produce different sized windows, as indicated by the mgs option.  Mov-
  170.      ing the cursor while holding the button down will move the magnifying
  171.      glass.
  172.  
  173.      Also, the scrollbars behave in the standard way.  The buttons work the
  174.      expected way.  The page gadget lets you enter a direct page number.
  175.  
  176.    ENVIRONMENT
  177.      For access to persistent defaults, EGSDVI reads an environment file named
  178.      "TEX:.egsdvidefaults".  This file contains the options listed above.  Each
  179.      line of the file consists of a keyword and its arguments, separated by
  180.      spaces or tabs.  Comment lines start with a semicolon as the first
  181.      character.  Additionally, there can be the environment variables explained
  182.      in the following paragraph.
  183.  
  184.      The environment variable `DVIFONTS' determines the path(s) searched for
  185.      fonts in the following manner.  The string consists of one or more strings
  186.      separated by semicolons.  In each such string, the substring `%f' is
  187.      changed to the font name; `%d' is changed to the magnification; and `%p'
  188.      is changed to the font family (`gf', `pk', or `pxl'). If no `%f' appears
  189.      in the string, then the string `/%f.%d%p' is added on the end. For
  190.      example, if the string is `/usr/local/tex/fonts' and the font is cmr10 at
  191.      300dpi, then it searches for /usr/local/tex/fonts/cmr10.300gf,
  192.      /usr/local/tex/fonts/cmr10.300pk, and /usr/local/tex/fonts/cmr10.1500pxl,
  193.      in that order.  An extra semicolon anywhere in the `DVIFONTS' variable
  194.      causes the system default paths to be tried at that point.  If the font is
  195.      not found in the desired size, then EGSDVI will try to find the nearest
  196.      size.  If the font cannot be found at all, then EGSDVI will try to vary
  197.      the point size of the font (within a certain range), and if this fails,
  198.      then it will use the font specified as the alternate font (cf. altfont).
  199.  
  200.      The default for DVIFONTS is "TEX:pk/%d/%f.%d%p", well suited for the
  201.      public domain TeX implementation PasTeX.
  202.  
  203.      For compatibility with TeX, you may also use `TEXFONTS' in place of
  204.      `DVIFONTS', although in that case the variable should not include any
  205.      `%' specifiers.  The reason for recognizing TEXFONTS is that certain
  206.      versions of TeX also support the convention regarding an extra colon in
  207.      the font path; therefore, users who create their own fonts can put both
  208.      their .tfm and raster files in the same directory and do `TEXFONTS
  209.      :MFdir' or `TEXFONTS MFdir:' in order to get both TeX and EGSDVI to search
  210.      their directory in addition to the system standard directories. The
  211.      DVIFONTS variable overrides the TEXFONTS variable, so that on those sites
  212.      where TEXFONTS must be set explicitly, and therefore this feature is not
  213.      useful, the DVIFONTS may be omitted to cause EGSDVI to ignore TEXFONTS.
  214.  
  215.      EGSDVI also recognizes the PKFONTS variable, which is checked after DVI-
  216.      FONTS but before TEXFONTS.
  217.  
  218.      The `DVISIZES' variable must be set to indicate which sizes of fonts are
  219.      available.  It should consist of a list of numbers separated by colons. If
  220.      the list begins with a colon, the system default sizes are used, as well.
  221.      Sizes are expressed in dots per inch; decimals may be used for `pxl'
  222.      files: for example, a 300 dots per inch file magnified by half a step
  223.      comes out to 1643 dots per five inches, which should be encoded as 328.6.
  224.      The current default set of sizes is 300 : 328.6 : 360 : 432 : 518.4 : 622
  225.      : 746.4.  EGSDVI will also try the actual size of the font before trying
  226.      any of the given sizes.
  227.  
  228.      Virtual fonts are also supported, although EGSDVI does not have any
  229.      built-in fonts to which they can refer.  The search path for .vf files
  230.      can be specified with the `DVIVFS' environment variable in a similar
  231.      manner to that for the `DVIFONTS' variable.  EGSDVI will also check the
  232.      VFFONTS variable if the DVIFONTS variable is not set.  Virtual fonts are
  233.      searched for immediately after looking for the font as a normal font in
  234.      the exact size specified.
  235.  
  236.      It's possible to automatically invoce MetaFont for creating fonts not
  237.      available.  For this, the DVIMAKEPK environment variable can be used.  The
  238.      format of DVIMAKEPK should be "scriptname %n %d %b %m".  "scriptname" is
  239.      the name of the shell script to be started in order to call MetaFont.
  240.      It's up to you to write a script that calls MetaFont appropriately. Before
  241.      the script is called, the % arguments are substituted. %n is substituted
  242.      by the font name, such as `cmr10', %d by the resolution the font is needed
  243.      at, %b by the base resolution, useful for figuring out the mode to make
  244.      the font in, and %m is a string to pass to MF as the magnification. The
  245.      default script name is "MakeTeXPK".
  246.  
  247.    AUTHORS
  248.      Eric Cooper, CMU, did a version for direct output to a QVSS.  Modified
  249.      for X by Bob Scheifler, MIT Laboratory for Computer Science.  Modified
  250.      for X11 by Mark Eichin, MIT SIPB.  Additional enhancements by many oth-
  251.      ers.  EGS port by Dietmar Heidrich.
  252.  
  253.      This manual is based on the XDVI manual.
  254.